跳到主要内容

点击 UI 元素 (ui_element.click)

该函数在 20260507 以后版本方可使用

声明​

状态, 信息或错误信息 = ui_element.click(选择器或元素 [, 选项 ])

参数​

  • 选择器或元素
    表型,可以是 选择器、查询返回的元素,或 { x = 横坐标, y = 纵坐标 } 坐标表。
  • 选项
    可选参数,表型,可参考 通用选项说明。

返回值​

  • 状态
    布尔型,成功时为 true,失败时为 nil。
  • 信息或错误信息
    成功时为表型动作信息,失败时为文本型错误原因。

说明​

用于点击按钮、列表项、键盘按键或其它可点击 UI。 坐标表中的坐标单位为物理像素。固定坐标点击请优先使用 touch.tap。 匹配多个目标且无法判断唯一目标时可能返回 nil, "ambiguous target"。

示例​

local ui_element = require("ui_element")

local ok, info_or_err = ui_element.click({
title = "继续",
role = "button",
})

if not ok then
sys.toast(info_or_err)
end

注:上述代码中使用了非本章函数 sys.toast